SetWindowProperty

PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

SetWindowProperty

Associates an arbitrary piece of data with a window.



 
pascal OSStatus SetWindowProperty (

                     WindowPtr window,

                     PropertyCreator propertyCreator,

                     PropertyTag propertyTag,

                     UInt32 propertySize,

                     void *propertyBuffer);

window: A value of type WindowPtr . Pass a pointer to the window with which data is to be associated.
propertyCreator: A four-character code. Pass the creator code (typically, the application's signature) of the data to be associated.
propertyTag: A four-character code. Pass a value identifying the data to be associated. You define the tag your application uses to identify the data; this code is not to be confused with the file type for the data.
propertySize: Pass a value specifying the size of the data to be associated.
propertyBuffer: Pass a pointer to the data to be associated.
function result: A result code. See Result Codes.

DISCUSSION

Data set with the SetWindowProperty function may be obtained with the function GetWindowProperty and removed with the function RemoveWindowProperty . See Managing Multiple Windows for a discussion of using the SetWindowProperty function.

VERSION NOTES

Available with Mac OS 8.5 and later.